Nota: Este documento es parte de una traducci�n al castellano de la Recomendaci�n del W3C "HTML 4.01 Specification" (m�s informaci�n). Puede consultar la versi�n original del mismo. Para cualquier comentario o correcci�n acerca de la traducci�n p�ngase en contacto con el traductor en jrpozo arroba conclase punto net. Gracias por su colaboraci�n.
V�ase el Aviso de copyright de la traducci�n.
Contenidos
Los scripts ofrecen a los autores la posibilidad de extender los documentos HTML de maneras activas e interactivas. Por ejemplo:
Hay dos tipos de scripts que los autores pueden asociar a un documento HTML:
Nota. Esta especificaci�n incluye informaci�n m�s detallada sobre scripts en la secci�n sobre macros de scripts.
Las siguientes secciones tratan sobre cuestiones que afectan a los agentes de usuario que soportan scripts.
<!ELEMENT SCRIPT - - %Script; -- sentencias de script --> <!ATTLIST SCRIPT charset %Charset; #IMPLIED -- codif. de caracteres del recurso vinculado-- type %ContentType; #REQUIRED -- tipo de contenido del lenguaje de scripts -- src %URI; #IMPLIED -- URI del script externo -- defer (defer) #IMPLIED -- El AU puede retrasar la ejecuci�n -- >
Etiqueta inicial: obligatoria, Etiqueta final: obligatoria
Definiciones de atributos
Atributos definidos en otros lugares
El elemento SCRIPT coloca un script dentro de un documento. Este elemento puede aparecer cualquier n�mero de veces en el HEAD o en el BODY de un documento HTML.
El script puede estar definido dentro de los contenidos del elemento SCRIPT o en un fichero externo. Si el atributo src no est� establecido, los agentes de usuario deben interpretar que los contenidos del elemento son el script. Si src tiene un valor URI, los agentes de usuario no deben tener en cuenta los contenidos del elemento y deben obtener el script mediante el URI. Obs�rvese que el atributo charset se refiere a la codificaci�n de caracteres del script designado por el atributo src; no afecta al contenido del elemento SCRIPT.
Los scripts son evaluados por motores de scripts, con los cuales deben poder comunicarse los agentes de usuario.
La sintaxis de los datos de scripts depende del lenguaje de scripts.
Al no estar ligado el HTML a un lenguaje de scripts espec�fico, los autores de los documentos deben decir expl�citamente a los agentes de usuario el lenguaje de cada script. Esto puede hacerse o bien mediante una declaraci�n por defecto o bien mediante una declaraci�n local.
Los autores deber�an especificar el lenguaje de scripts por defecto de todos los scripts de un documento incluyendo la siguiente declaraci�n META en el HEAD:
<META http-equiv="Content-Script-Type" content="type">
donde "type" es un tipo de contenido que se refiere al lenguaje de scripts. Como ejemplos de este valor tenemos "text/tcl", "text/javascript", "text/vbscript".
En ausencia de una declaraci�n META, el valor por defecto puede ser establecido con un encabezado HTTP "Content-Script-Type".
Content-Script-Type: type
donde "type" es nuevamente un tipo de contenido que se refiere al lenguaje de scripts.
Los agentes de usuario deber�an determinar el lenguaje de scripts por defecto de un documento de acuerdo con los siguiente pasos (ordenados de prioridad m�s alta a m�s baja):
Los documentos que no especifiquen informaci�n relativa al lenguaje de scripts por defecto y que contengan elementos que especifiquen un script de evento intr�nseco son incorrectos. Los agentes de usuario a�n pueden intentar interpretar scripts especificados incorrectamente, pero no se requiere que lo hagan. Las herramientas de creaci�n deber�an generar informaci�n sobre el lenguaje de scripts por defecto para ayudar a que los autores eviten la creaci�n de documentos incorrectos.
Se debe especificar el atributo type de todos los elementos SCRIPT de un documento. El valor del atributo type de un elemento SCRIPT prevalece sobre el languaje de scripts por defecto de ese elemento.
En este ejemplo, declaramos que el lenguaje de scripts por defecto es "text/tcl". Incluimos un SCRIPT en la cabecera, cuyo script se localiza en un fichero externo y que est� en el lenguaje de scripts "text/vbscript". Tambi�n incluimos un SCRIPT en el cuerpo, que contiene su propio script escrito en "text/javascript".
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
"http://www.w3.org/TR/html4/strict.dtd">
<HTML>
<HEAD>
<TITLE>Un documento con SCRIPT</TITLE>
<META http-equiv="Content-Script-Type" content="text/tcl">
<SCRIPT type="text/vbscript" src="http://algunsitio.com/progs/vbcalc">
</SCRIPT>
</HEAD>
<BODY>
<SCRIPT type="text/javascript">
...algo en JavaScript...
</SCRIPT>
</BODY>
</HTML>
Cada lenguaje de scripts tiene sus propias convenciones para referirse a objetos HTML desde dentro del script. Esta especificaci�n no define un mecanismo est�ndar para referirse a objetos HTML.
Sin embargo, los scripts deber�an hacer referencia a un elemento de acuerdo con su nombre asignado. Los motores de scripts deber�an seguir las siguientes reglas de precedencia cuando identifiquen un elemento: un atributo name prevalece sobre un atributo id si ambos est�n establecidos. En caso contrario, se puede usar uno u otro.
Nota. Se avisa a los autores de documentos HTML que se espera que haya cambios en el �mbito de los eventos intr�nsecos (p.ej., c�mo se ligan los scripts a los eventos). La investigaci�n en este campo est� siendo llevada a cabo por miembros del Grupo de Trabajo del Modelo de Objetos del Documento del W3C (ver el sitio web del W3C en http://www.w3.org/ para m�s informaci�n).
Definiciones de atributos
Es posible asociar una acci�n con un cierto n�mero de eventos que ocurren cuando un usuario interacciona con un agente de usuario. Cada uno de los "eventos intr�nsecos" reci�n enumerados toma como valor un script. El script se ejecuta cada vez que el evento ocurre para ese elemento. La sintaxis de los datos del script depende del lenguaje de scripts.
Los elementos de control tales como INPUT, SELECT, BUTTON, TEXTAREA y LABEL responden todos a ciertos eventos intr�nsecos. Cuando estos elementos no aparecen dentro de un formulario, se pueden emplear para enriquecer la interfaz gr�fica del usuario del documento.
Por ejemplo, los autores pueden querer incluir botones en sus documentos que no env�en un formulario pero que puedan comunicarse con un servidor cuando son activados.
Los siguientes ejemplos muestran posibles comportamientos de controles e interfaces de usuario basados en eventos intr�nsecos.
En el siguiente ejemplo, nombreUsuario es un campo de texto obligatorio. Cuando un usuario intenta abandonar el campo, el evento onblur llama a una funci�n JavaScript para confirmar que nombreUsuario tiene un valor aceptable.
<INPUT NAME="nombreUsuario" onblur="validarNombreUsuario(this.value)">
Aqu� tenemos otro ejemplo en JavaScript:
<INPUT NAME="num"
onchange="if (!checkNum(this.value, 1, 10))
{this.focus();this.select();} else {thanks()}"
VALUE="0">
Aqu� tenemos un ejemplo en VBScript de un manejador de eventos para un campo de texto:
<INPUT name="edit1" size="50">
<SCRIPT type="text/vbscript">
Sub edit1_cambiado()
If edit1.value = "abc" Then
button1.enabled = True
Else
button1.enabled = False
End If
End Sub
</SCRIPT>
Aqu� tenemos el mismo ejemplo usando Tcl:
<INPUT name="edit1" size="50">
<SCRIPT type="text/tcl">
proc edit1_cambiado {} {
if {[edit value] == abc} {
button1 enable 1
} else {
button1 enable 0
}
}
edit1 onChange edit1_cambiado
</SCRIPT>
Aqu� tenemos un ejemplo en JavaScript que asocia un evento con un script. En primer lugar vemos un manejador sencillo de clics:
<BUTTON type="button" name="miboton" value="10">
<SCRIPT type="text/javascript">
function mi_onclick() {
. . .
}
document.form.miboton.onclick = mi_onclick
</SCRIPT>
</BUTTON>
Aqu� tenemos un manejador de ventanas m�s interesante:
<SCRIPT type="text/javascript">
function mi_onload() {
. . .
}
var ventana = window.open("algun/otro/URI")
if (ventana) ventana.onload = mi_onload
</SCRIPT>
En Tcl esto ser�a algo as�:
<SCRIPT type="text/tcl">
proc mi_onload {} {
. . .
}
set ventana [window open "algun/otro/URI"]
if {$ventana != ""} {
$ventana onload mi_onload
}
</SCRIPT>
Obs�rvese que un "document.write" o sus sentencias equivalentes en un manejador de eventos intr�nsecos lo que hacen es crear un nuevo documento y escribir en �l, no modificar el documento actual.
Los scripts que se ejecutan cuando un documento es cargado pueden modificar los contenidos del documento din�micamente. La capacidad de hacer esto depende del lenguaje de scripts en s� (p.ej., la sentencia "document.write" en el modelo de objetos de HTML no est� soportada por algunas marcas).
La modificaci�n din�mica de un documento puede ser modelizada de la siguiente manera:
Los documentos HTML deben ser conformes con el DTD del HTML tanto antes como despu�s del procesamiento de cualquiera de los elementos SCRIPT.
El ejemplo siguiente ilustra c�mo puede un script modificar un documento din�micamente. El siguiente script:
<TITLE>Documento de prueba</TITLE>
<SCRIPT type="text/javascript">
document.write("<p><b>�Hola Mundo!<\/b>")
</SCRIPT>
tiene el mismo efecto que este c�digo HTML:
<TITLE>Documento de prueba</TITLE> <P><B>�Hola Mundo!</B>
Las siguientes secciones tratan sobre c�mo pueden los autores crear documentos que funcionen para agentes de usuario que no soporten scripts.
<!ELEMENT NOSCRIPT - - (%block;)+ -- contenedor de contenido alternativo para representaci�n no basada en scripts --> <!ATTLIST NOSCRIPT %attrs; -- %coreattrs, %i18n, %events -- >
Etiqueta inicial: obligatoria, Etiqueta final: obligatoria
El elemento NOSCRIPT permite a los autores proporcionar contenido alternativo cuando un script no es ejecutado. El contenido de un elemento NOSCRIPT s�lo deber�a ser representado por un agente de usuario capaz de reconocer scripts en los casos siguientes:Los agentes de usuario que no soporten scripts en el lado del cliente deben representar los contenidos de este elemento.
En el ejemplo siguiente, un agente de usuario que ejecute el SCRIPT incluir� en el documento algunos datos creados din�micamente. Si el agente de usuario no soporta scripts, el usuario a�n podr� obtener los datos por medio de un v�nculo.
<SCRIPT type="text/tcl"> ...scripts Tcl para insertar datos... </SCRIPT> <NOSCRIPT> <P>Acceder a los <A href="http://algunsitio.com/datos">datos.</A> </NOSCRIPT>
Es probable que los agentes de usuario que no reconozcan el elemento SCRIPT representen los contenidos del elemento como texto. Algunos motores de scripts, incluyendo los de los lenguajes JavaScript, VBScript y Tcl, permiten que las sentencias de los scripts est�n contenidas en un comentario SGML. Los agentes de usuario que no reconozcan el elemento SCRIPT ignorar�n as� el comentario, mientras que los motores de scripts que funcionen correctamente entender�n que los scripts de los comentarios deber�an ser ejecutados.
Otra soluci�n al problema es mantener los scripts en documentos externos y hacer referencia a ellos con el atributo src.
Comentando scripts en Javascript
El motor de JavaScript permite que aparezca la cadena "<!--" al principio
del elemento SCRIPT, e ignora el resto de los caracteres hasta el final de
la l�nea. JavaScript interpreta "//" como el inicio de un comentario que
se extiende hasta el final de la l�nea actual. Esta cadena es necesaria para
ocultar la cadena "-->" al analizador JavaScript.
<SCRIPT type="text/javascript">
<!-- para ocultar los contenidos del script a los navegadores viejos
function cuadrado(i) {
document.write("La llamada pas� ", i ," a la funci�n.","<BR>")
return i * i
}
document.write("La funci�n devolvi� ",cuadrado(5),".")
// dejar de ocultar contenidos a los navegadores viejos -->
</SCRIPT>
Comentando scripts en VBScript
En VBScript, un car�cter de comilla simple hace que el resto de la l�nea actual
sea tratada como un comentario. Puede usarse por tanto para ocultar a VBScript
la cadena "-->", por ejemplo:
<SCRIPT type="text/vbscript">
<!--
Sub blabla()
...
End Sub
' -->
</SCRIPT>
Comentando scripts en TCL
En Tcl, el car�cter "#" comenta el resto de la l�nea:
<SCRIPT type="text/tcl">
<!-- para ocultar los contenidos del script a los navegadores viejos
proc cuadrado {i} {
document write "La llamada pas� $i a la funci�n.<BR>"
return [expr $i * $i]
}
document write "La funci�n devolvi� [cuadrado 5]."
# dejar de ocultar los contenidos a los navegadores viejos -->
</SCRIPT>
Nota. Algunos navegadores cierran los comentarios al encontrar el primer car�cter ">", de modo que para ocultar el contenido de los scripts de estos navegadores, se pueden invertir los operandos de los operadores relacionales y de desplazamiento (p.ej., usar "y < x" en vez de "x > y") o se pueden usar caracteres de escape dependientes del lenguaje de scripts para ">".